Configure on-premises installations of ebs to store uploaded files in a specified network file system directory. For example, to enable files to be scanned by the institution's anti-virus software.
Before configuring ebs to store uploaded files in a network file system directory, note the following:
-
All document uploads are handled through REST services. Therefore, the application server must have access to the storage location for the documents. If you're using load-balanced application servers, ensure that the servers have access to a shared network location.
-
You must carefully consider the backup frequency and recovery strategy for the files. You must also monitor storage capacity, to ensure that you do not run out of storage space.
-
All standard ebs processes should handle files stored either on disk or in the database. However, if custom processes directly access files, these processes will need to be considered.
-
Records are still created in the BLOBS table in the database. However, the BINARY_OBJECT column is left null and the file name contains a relative path, such as PEOPLE\75\75\DOCUMENT_ATTACHMENT_19012022032139497.png. A dynamic folder structure is used to avoid exceeding Windows file and folder limits.
-
Moving files out of the database reduces the size of the database, therefore making backup or restore operations faster.
Move files to a network location
If the storage location for your files is not on a local disk, you need to use service accounts to transfer the data. Ensure these service accounts have read and write permissions for the folder.
Move files to a network location as follows:
-
On ebs Central, go to System > Institution Settings, and select General (Cross-System). In the field Directory path for uploaded files when storing to file system, enter the network location of the folder. For example, \\TribalCollege\UploadedFiles\. Then, set the following fields to Y:
-
Store uploaded documents in the file system
-
Store uploaded learner documents in the database
-
-
On the server, configure domain service accounts for web services and workflow services.
-
Define the web-services account. Go to IIS > Sites > Web-services website > Authentication > Anonymous access, and define the web-services account. Then, recycle the web-services application pool.
- Set the workflow service account. Go to Services > ebs workflow service > Properties > Log on tab, and set the workflow service account. Then, restart the workflow service.
-
Check that the web services account and workflow services have full sharing permissions on the defined file system directory.
Note that you can also move specific files from the database to a file system directory using a workflow activity. For more information, go to Use the MoveBlobsFromDbToDisk Activity.